.TH std::isspace(std::locale) 3 "2024.06.10" "http://cppreference.com" "C++ Standard Libary"
.SH NAME
std::isspace(std::locale) \- std::isspace(std::locale)

.SH Synopsis
   Defined in header <locale>
   template< class CharT >
   bool isspace( CharT ch, const locale& loc );

   Checks if the given character is classified as a whitespace character by the given
   locale's std::ctype facet.

.SH Parameters

   ch  - character
   loc - locale

.SH Return value

   Returns true if the character is classified as a whitespace character, false
   otherwise.

.SH Possible implementation

   template<class CharT>
   bool isspace(CharT ch, const std::locale& loc)
   {
       return std::use_facet<std::ctype<CharT>>(loc).is(std::ctype_base::space, ch);
   }

.SH Example

   Demonstrates the use of std::isspace() with different locales (OS-specific).


// Run this code

 #include <iostream>
 #include <locale>

 void try_with(wchar_t c, const char* loc)
 {
     std::wcout << "isspace('" << c << "', locale(\\"" << loc << "\\")) returned "
                << std::boolalpha << std::isspace(c, std::locale(loc)) << '\\n';
 }

 int main()
 {
     const wchar_t EM_SPACE = L'\\u2003'; // Unicode character 'EM SPACE'
     try_with(EM_SPACE, "C");
     try_with(EM_SPACE, "en_US.UTF8");
 }

.SH Possible output:

 isspace(' ', locale("C")) returned false
 isspace(' ', locale("en_US.UTF8")) returned true

.SH See also

   isspace  checks if a character is a space character
            \fI(function)\fP
   iswspace checks if a wide character is a space character
            \fI(function)\fP
